home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / unbufcall.z / unbufcall
Encoding:
Text File  |  1998-10-30  |  7.0 KB  |  131 lines
  1.  
  2.  
  3.  
  4. uuuunnnnbbbbuuuuffffccccaaaallllllll((((DDDD3333))))                                                    uuuunnnnbbbbuuuuffffccccaaaallllllll((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _uuuu_nnnn_bbbb_uuuu_ffff_cccc_aaaa_llll_llll - cancel a pending _bbbb_uuuu_ffff_cccc_aaaa_llll_llll request
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_tttt_rrrr_eeee_aaaa_mmmm_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  14.      _vvvv_oooo_iiii_dddd _uuuu_nnnn_bbbb_uuuu_ffff_cccc_aaaa_llll_llll_((((_tttt_oooo_iiii_dddd______tttt _i_d_))))_;;;;
  15.  
  16.    AAAArrrrgggguuuummmmeeeennnnttttssss
  17.      _i_d        Non-zero identifier returned from a prior call to _bbbb_uuuu_ffff_cccc_aaaa_llll_llll(D3)
  18.                or _eeee_ssss_bbbb_bbbb_cccc_aaaa_llll_llll(D3).
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      _uuuu_nnnn_bbbb_uuuu_ffff_cccc_aaaa_llll_llll cancels the pending _bbbb_uuuu_ffff_cccc_aaaa_llll_llll or _eeee_ssss_bbbb_bbbb_cccc_aaaa_llll_llll request specified by
  22.      _i_d.
  23.  
  24.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  25.      None
  26.  
  27. UUUUSSSSAAAAGGGGEEEE
  28.      If _uuuu_nnnn_bbbb_uuuu_ffff_cccc_aaaa_llll_llll is called while any function called by the pending _bbbb_uuuu_ffff_cccc_aaaa_llll_llll
  29.      or _eeee_ssss_bbbb_bbbb_cccc_aaaa_llll_llll request is running, the call to _uuuu_nnnn_bbbb_uuuu_ffff_cccc_aaaa_llll_llll has no effect.
  30.  
  31.    LLLLeeeevvvveeeellll
  32.      Base or Interrupt.
  33.  
  34.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  35.      Does not sleep.
  36.  
  37.      Driver-defined basic locks, read/write locks, and sleep locks may not be
  38.      held across calls to this function.
  39.  
  40.    EEEExxxxaaaammmmpppplllleeee
  41.      See _bbbb_uuuu_ffff_cccc_aaaa_llll_llll for the other half of this example.
  42.  
  43.      In the module close routine, if a _bbbb_uuuu_ffff_cccc_aaaa_llll_llll request is pending (line 14),
  44.      we cancel it (line 15).  Otherwise, if a _iiii_tttt_iiii_mmmm_eeee_oooo_uuuu_tttt request is pending
  45.      (line 16), we cancel it (line 17).  Then the _mmmm______tttt_yyyy_pppp_eeee field in the module's
  46.      private data structure is set to 0, indicating no pending _bbbb_uuuu_ffff_cccc_aaaa_llll_llll or
  47.      _iiii_tttt_iiii_mmmm_eeee_oooo_uuuu_tttt.
  48.  
  49.       _1111  _ssss_tttt_rrrr_uuuu_cccc_tttt _mmmm_oooo_dddd _{{{{
  50.       _2222   _llll_oooo_nnnn_gggg _mmmm______iiii_dddd_;;;;
  51.       _3333   _cccc_hhhh_aaaa_rrrr _mmmm______tttt_yyyy_pppp_eeee_;;;;
  52.           _...._...._....
  53.       _4444  _}}}}_;;;;
  54.       _5555  _####_dddd_eeee_ffff_iiii_nnnn_eeee _TTTT_IIII_MMMM_EEEE_OOOO_UUUU_TTTT _1111
  55.       _6666  _####_dddd_eeee_ffff_iiii_nnnn_eeee _BBBB_UUUU_FFFF_CCCC_AAAA_LLLL_LLLL _2222
  56.          _...._...._....
  57.       _7777  _mmmm_oooo_dddd_cccc_llll_oooo_ssss_eeee_((((_qqqq_,,,, _ffff_llll_aaaa_gggg_,,,, _cccc_rrrr_pppp_))))
  58.       _8888   _qqqq_uuuu_eeee_uuuu_eeee______tttt _****_qqqq_;;;;
  59.       _9999   _iiii_nnnn_tttt _ffff_llll_aaaa_gggg_;;;;
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. uuuunnnnbbbbuuuuffffccccaaaallllllll((((DDDD3333))))                                                    uuuunnnnbbbbuuuuffffccccaaaallllllll((((DDDD3333))))
  70.  
  71.  
  72.  
  73.      _1111_0000   _cccc_rrrr_eeee_dddd______tttt _****_cccc_rrrr_pppp_;;;;
  74.      _1111_1111  _{{{{
  75.      _1111_2222   _ssss_tttt_rrrr_uuuu_cccc_tttt _mmmm_oooo_dddd _****_mmmm_oooo_dddd_pppp_;;;;
  76.      _1111_3333   _mmmm_oooo_dddd_pppp _==== _((((_ssss_tttt_rrrr_uuuu_cccc_tttt _mmmm_oooo_dddd _****_))))_qqqq_----_>>>>_qqqq______pppp_tttt_rrrr_;;;;
  77.      _1111_4444   _iiii_ffff _((((_mmmm_oooo_dddd_pppp_----_>>>>_mmmm______tttt_yyyy_pppp_eeee _====_==== _BBBB_UUUU_FFFF_CCCC_AAAA_LLLL_LLLL_))))
  78.      _1111_5555        _uuuu_nnnn_bbbb_uuuu_ffff_cccc_aaaa_llll_llll_((((_mmmm_oooo_dddd_pppp_----_>>>>_mmmm______iiii_dddd_))))_;;;;
  79.      _1111_6666   _eeee_llll_ssss_eeee _iiii_ffff _((((_mmmm_oooo_dddd_pppp_----_>>>>_mmmm______tttt_yyyy_pppp_eeee _====_==== _TTTT_IIII_MMMM_EEEE_OOOO_UUUU_TTTT_))))
  80.      _1111_7777        _uuuu_nnnn_tttt_iiii_mmmm_eeee_oooo_uuuu_tttt_((((_mmmm_oooo_dddd_pppp_----_>>>>_mmmm______iiii_dddd_))))_;;;;
  81.      _1111_8888   _mmmm_oooo_dddd_pppp_----_>>>>_mmmm______tttt_yyyy_pppp_eeee _==== _0000_;;;;
  82.           _...._...._....
  83.  
  84. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  85.      _bbbb_uuuu_ffff_cccc_aaaa_llll_llll(D3), _eeee_ssss_bbbb_bbbb_cccc_aaaa_llll_llll(D3)
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  125.  
  126.  
  127.                                                                         PPPPaaaaggggeeee 2222
  128.  
  129.  
  130.  
  131.